home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / programming / c / icu-1.3.1 / icuapps / locexp / readme < prev   
Text File  |  2000-02-23  |  3KB  |  100 lines
  1. LOCALE EXPLORER  :  by Steven R. Loomis, IBM
  2. -------------------------
  3.  
  4. This is the source for the locale explorer CGI which is on IBM's
  5. external website at:
  6.  
  7.     http://www10.software.ibm.com/developerworks/opensource/icu/localeexplorer
  8.  
  9.  The purpose of this CGI is to (1) make available the locale data for
  10. viewing, and (2) show off the ICU.  Hopefully, it will also be an
  11. interesting and useful sample.  Please let us know (via the newsgroup)
  12. if this is useful or not, if you have any questions, or comments..
  13.  
  14.  The tools and routines were also built to support locale explorer
  15. first, however we are continuing to try to make them more general
  16. purpose.  If you see something you think should be part of the ICU,
  17. by all means file a bug and explain what you want and how it can be
  18. made better!
  19.  
  20.  Locale explorer isn't quite as much of a 'ready-to-go' application as
  21. some of the others in icuapps.  Installing it takes some familliarity
  22. with and a running web server.  
  23.  
  24.  
  25. BUILDING
  26. --------
  27.  
  28.  To build the locale explorer, first you must have the ICU built and
  29. installed of course (see ../README).  Secondly, the uconv and usort
  30. projects should be built and installed.   In short, your best bet is
  31. to simply type 'make install' from the top level of icuapps.
  32.  
  33. INSTALLING
  34. ----------
  35.  
  36.  After 'make install' is run in the locexp directory, the locale
  37. explorer itself will be installed in PREFIX/bin and it's data will be
  38. in the 'locexp' directory under the ICU's own installed data
  39. directory. 
  40.  
  41.  If the binaries and data are left in these directories, then the
  42. 'locexp' program can simply be called directly as a CGI.  On one
  43. server, it is installed this way: [apache syntax]
  44.  
  45.    # The prefix is /home/srl/II
  46.    ScriptAlias /localeexplorer /home/srl/II/bin/locexp
  47.  
  48.  There are also some HTML and image files in the 'html'
  49. directory. Change the URLPREFIX variable in locexp/Makefile.in such
  50. that if URLPREFIX is set to '/~gumby/' for example, then the file
  51. 'explore.gif' is accessible as:
  52.  
  53.       /~gumby/localeexplorer/explore.gif
  54.  
  55.  
  56. DEBUGGING
  57. --------- 
  58.  
  59.  There is also a script called 'testVars.sh' in the tools directory
  60. that can aid in command-line debugging. See that script for more
  61. information. 
  62.  
  63. ICU-DATA
  64. --------
  65.  
  66.  The locale explorer works best when installed with a few patches to
  67. the ICU data.  The file 'icudata.tgz' contains some additional data
  68. you may install in your icu data directory.  See the README in that
  69. directory for more information.
  70.  
  71.  In addition, there are a few new locales thrown in here. They are to
  72. be considered in 'draft' stage. Please give them a try!  You can add
  73. them to your index.txt [the ICU one, not the one in the locexp
  74. directory] if you want them to show up in the locale explorer's list.
  75. Consider these a bonus.
  76.  
  77.  There are some make targets in the top-level locexp/Makefile.in which
  78. will assist you in using this data.
  79.   Note that none of these will install the data for you.
  80.  
  81. #  make icudata-dir 
  82.  
  83.     This will unpack the .tgz into the icudata directory 
  84.  
  85. #  make icudata-res   icudata-conv 
  86.  
  87.     These targets will build the resource and converter files,
  88.     respectively. 
  89.  
  90. #  make icudata-all  
  91.  
  92.      All of the above.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.